home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 4 / The Arsenal Files 4 (Arsenal Computer).ISO / pinnacle / see.inf < prev    next >
Text File  |  1993-01-16  |  13KB  |  366 lines
  1.  ╔══════════════════╗
  2.  ║                  ║
  3.  ║  WHAT IS "SEE"?  ║
  4.  ║                  ║
  5.  ╚══════════════════╝
  6.  
  7.  
  8.   SEE is a utility for viewing and printing text files. It can also display
  9.   hex files in a format that makes it easy for you to visually scan the file.
  10.   SEE's small size and low price (i.e. FREE!) makes it ideal for inclusion
  11.   with other software, so that the user can read the documentation files.
  12.  
  13.   SEE also lets you extract portions of text from the listing.  The extracted
  14.   portion can be copied to the printer or to a text file.
  15.  
  16.   NEW FOR '93:  SEE now comes with a configuration program (SEESETUP.EXE)
  17.   which lets you customize SEE to work the way YOU want it to.  SEE always
  18.   looks in the logged (i.e. current) drive and directory before checking its
  19.   primary configuration file, so you can create application-specific versions
  20.   of SEE!  For details, see the section entitled "Configuring SEE".
  21.  
  22.  
  23.  
  24.  ╔════════════════════╗
  25.  ║                    ║
  26.  ║  HOW TO USE "SEE"  ║
  27.  ║                    ║
  28.  ╚════════════════════╝
  29.  
  30.  
  31.  ╒═══════════════╕
  32.  │  STARTING UP  │
  33.  ╘═══════════════╛
  34.  
  35.  
  36.   At the DOS command prompt, enter SEE followed by the name of the file you
  37.   want to read.  For example, the command:
  38.  
  39.   SEE AMAZE.DOC
  40.  
  41.   would display the file named AMAZE.DOC.
  42.  
  43.   SEE automatically detects the type of file being viewed and selects the
  44.   appropriate display mode (text or hex).
  45.  
  46.  
  47.   ═════════
  48.   WILDCARDS
  49.   ═════════
  50.  
  51.   If you specify a "DOS Wildcard", you will see a menu of file names that
  52.   match. You can move the cursor to the file you want by using your arrow
  53.   keys.  Then press Enter to see the file.
  54.  
  55.   For example:
  56.  
  57.   SEE *.INF
  58.  
  59.   would show you all files with the extension INF.
  60.  
  61.   If you omit any file specification, SEE assumes you mean *.* so that the
  62.   following command would let you select from all files in the current
  63.   directory:
  64.  
  65.   SEE
  66.  
  67.  
  68.   ═══════════════════════
  69.   CROSS-DIRECTORY VIEWING
  70.   ═══════════════════════
  71.  
  72.   SEE normally looks for the files in your current drive and directory.
  73.   However, you can have it look at another drive or directory by specifying
  74.   the path name accordingly, as in this example:
  75.  
  76.   SEE D:\MYDIR\ACCOUNTS\PAYROLL.TXT
  77.  
  78.  
  79.   ══════════
  80.   MONOCHROME
  81.   ══════════
  82.  
  83.   SEE can normally detect if you have a color display card or not, but no
  84.   DOS program can detect if your monitor can actually display color.  (Some
  85.   people have color display cards with monochrome monitors)  If SEE is
  86.   displaying text in color and you want to force it to display in
  87.   monochrome, add  /M  to the file specification.  For example:
  88.  
  89.   SEE MYFILE.TXT /M
  90.  
  91.   This would display the file MYFILE.TXT in black and white.
  92.  
  93.   You can configure SEE (using the SEESETUP program) to always start up in
  94.   monochrome mode.  This will save you the bother of always having to specify
  95.   the /M parameter.
  96.  
  97.  
  98.   ══════════
  99.   QUICK HELP
  100.   ══════════
  101.  
  102.   For a quick summary of SEE's functions, enter the following command at the
  103.   DOS prompt:
  104.  
  105.   SEE /?
  106.  
  107.   This will display several help screens.
  108.  
  109.   If you are already viewing a file, you can press the F1 key to see the same
  110.   screens.
  111.  
  112.   At the end of each screen you can press the spacebar to continue to the next
  113.   screen, or press Esc to return to what you were doing (i.e. DOS prompt or
  114.   viewing).
  115.  
  116.  
  117.  
  118.  ╒════════════════╕
  119.  │  READING FILES │
  120.  ╘════════════════╛
  121.  
  122.  
  123.   ══════════════
  124.   SCROLLING KEYS
  125.   ══════════════
  126.  
  127.   Once you have selected the file you want to read, you can scroll back and
  128.   forth in the file a line at a time, using the arrow keys.  You can also jump
  129.   back and forth a screen at a time, using the PgUp and PgDn keys.
  130.  
  131.   The Home and End keys position the file to the beginning and end,
  132.   respectively.
  133.  
  134.   The spacebar key moves forward one screen each time it is pressed.  When you
  135.   reach the end of the file, you are returned to the previous operation (i.e.
  136.   the file selection menu, if you started SEE with DOS wildcards, or the DOS
  137.   prompt otherwise).
  138.  
  139.   The left and right-arrow keys scroll text left and right one character at a
  140.   time.  You can use these keys in conjunction with the Ctrl key to scroll
  141.   five characters at a time.
  142.  
  143.  
  144.   ═════════
  145.   THE L KEY  ──  Jump to a line
  146.   ═════════
  147.  
  148.   The L key will ask you for a line number.  It will then jump to that line,
  149.   positioning it at the first line of the viewing area.
  150.  
  151.  
  152.   ═════════
  153.   THE F KEY  ──  Find text
  154.   ═════════
  155.  
  156.   The F key will ask you for a text string.  If it finds that string in the
  157.   file, it will jump there, highlighting the line the text is on.  The line
  158.   is positioned in the middle of the screen, if possible.
  159.  
  160.   To search for the same text again, press the F3 function key.
  161.  
  162.   For information about the function keys (sometimes called "The F Keys"), see
  163.   the section entitled "The Function Keys", below.
  164.  
  165.  
  166.   ═════════
  167.   THE C KEY  ──  Copy part or all of the file to printer or file
  168.   ═════════
  169.  
  170.   The C key sends a copy of the file (or part of it) to your printer, or to
  171.   another file.  See the section entitled "Copying" for details.
  172.  
  173.   While using the C feature, remember that the Esc key will always return you
  174.   to your previous operation.  If you were looking at the help screens, it
  175.   returns you to the viewing window.  If you were viewing text, it returns you
  176.   to the file selection menu (if you started SEE with DOS wildcards) or the
  177.   DOS prompt otherwise.
  178.  
  179.   The Copy command asks many questions in order to determine what you want
  180.   to do.  To save time, you can use the SEESETUP program to specify default
  181.   values to these questions, or skip them altogether (using a preselected
  182.   value).
  183.  
  184.  
  185.   ═════════════════
  186.   THE FUNCTION KEYS
  187.   ═════════════════
  188.  
  189.   F 1  displays the help screens.  See "Quick Help", above, for additional
  190.        information about these screens.
  191.  
  192.   F 2  displays a "ruler" line, which lets you determine which column text
  193.        starts and ends.
  194.  
  195.   F 3  repeats the last Find operation (see "The F Key", above).
  196.  
  197.   F 4  sends a page eject character (ASCII 12, Hex $0C) to the printer.  You
  198.        can select the printer number.  By default it is printer LPT1 (or the
  199.        default printer number specified by SEESETUP).
  200.  
  201.   F 5  switches the display to 25 lines, in monochrome.
  202.  
  203.   F 6  switches the display to 25 lines, in color.
  204.  
  205.   F 7  switches the display to smaller letters, in monochrome, if you have the
  206.        appropriate display card.  If you have a CGA, Hercules or MCGA card,
  207.        nothing will happen.  If you have an EGA card, you will see 43 lines
  208.        on your screen.  A VGA display card will display 50 lines.
  209.  
  210.   F 8  does what the F7 key does, but uses color instead of monochrome.
  211.  
  212.   F 9  is not used.
  213.  
  214.   F10  is not used.
  215.  
  216.  
  217.  
  218.  ╔═══════════╗
  219.  ║           ║
  220.  ║  COPYING  ║
  221.  ║           ║
  222.  ╚═══════════╝
  223.  
  224.  
  225.   When you are viewing a file and you press the C (Copy) key, SEE will ask
  226.   you a few questions, then copy part (or all) of the file to the printer, or
  227.   to another file.
  228.  
  229.   The questions let you specify:
  230.  
  231.   PORTION:      Which part of the file (some, or all) should be copied.
  232.  
  233.   DESTINATION:  Which printer you want to print to (LPT1, LPT2 etc.) or which
  234.                 file you want to copy to (e.g. SAVE.TXT). If the file already
  235.                 exists, you can overwrite it, or add to the end.
  236.  
  237.   The following two questions apply to printing only:
  238.  
  239.   CONVERSION:   Whether to convert extended characters or not.
  240.  
  241.   FORM-FEED:    Whether the printer should "page eject" after printing.
  242.  
  243.   The printer questions are discussed in more detail, below.
  244.  
  245.   NOTE:  Before you start printing, make sure your printer is turned on,
  246.   is supplied with paper, and that the "Online" light is lit.  (On some
  247.   printers, the Online light may be labelled "Ready", or something similar.
  248.   Refer to your printer manual if you are not sure.)
  249.  
  250.   If at any time you wish to exit from the copying process, you can press the
  251.   Esc key.  If you were printing, you may have to turn your printer OFF for a
  252.   moment, then ON again, to reset it and clear its memory.
  253.  
  254.   The Copy command asks many questions in order to determine what you want
  255.   to do.  To save time, you can use the SEESETUP program to specify default
  256.   values to these questions, or skip them altogether (using a preselected
  257.   value).
  258.  
  259.  
  260.   ═══════════════════
  261.   PRINTER DESTINATION
  262.   ═══════════════════
  263.  
  264.   When you are asked to select a printer destination, choose the address of
  265.   the printer to which you are copying the text.  You can choose any printer
  266.   from LPT1 to LPT9.  (It is somewhat unusual to have a printer with an
  267.   address higher than LPT2.)
  268.  
  269.   If you are not sure, select LPT1.  Most PC-compatible computers have their
  270.   printer at that address.  Exception:  if your computer is sharing the
  271.   printer with other computers on a network, check with your network manager
  272.   before proceeding.
  273.  
  274.  
  275.   ══════════
  276.   CONVERSION
  277.   ══════════
  278.  
  279.   Many documents (such as this one) make use of the special characters that
  280.   are available on IBM-PC compatible computers.  Some printers, though
  281.   (particularly older printers and very high speed printers), can not print
  282.   these characters properly.
  283.  
  284.   If when you print, many of the characters come out wrong, you may have to
  285.   have them "converted".  The conversion process replaces these characters
  286.   with a "reasonable" substitution before printing them.  (Note that this
  287.   affects only the printing; the document you are viewing is NOT changed.)
  288.  
  289.   For example, accented letters can not be printed on all printers.  So an
  290.   accented "e" would be printed simply as "e", with no accent.  Line-drawing
  291.   characters (for boxes) are also a problem for some printers.  So the
  292.   vertical line character is replaced with the standard "split bar" character,
  293.   which looks almost the same.
  294.  
  295.  
  296.  
  297.  ╔═════════════════════╗
  298.  ║                     ║
  299.  ║  CONFIGURING "SEE"  ║
  300.  ║                     ║
  301.  ╚═════════════════════╝
  302.  
  303.  
  304.   The SEE program is set up to use reasonable values for all of its
  305.   operations.  For example, it will detect the kind of display card you have
  306.   and choose color or monochrome mode according, using the same number of
  307.   lines per screen that you had set before you called up SEE.
  308.  
  309.   However, you may wish to change some of the selections.  You can create a
  310.   configuration file (named SEE.CFG) using the SEESETUP configuration program
  311.   (SEESETUP.EXE).
  312.  
  313.   When SEE starts up, it looks in the current (i.e. logged) drive and
  314.   directory for a file named SEE.CFG.  If it does not find it there, it looks
  315.   in the SEE home directory (i.e. where the SEE.EXE file is located) for the
  316.   file.  If it finds the file, it uses the values it specifies.  If it does
  317.   NOT find it (in either the logged or home directory), SEE uses reasonable
  318.   default values that are appropriate for virtually all machines.
  319.  
  320.   To start up SEESETUP, enter SEESETUP at the DOS prompt.  Each configuration
  321.   screen can provide you with detailed explanations of each configuration
  322.   option -- press F1 whenever you need additional information.
  323.  
  324.  
  325.  
  326.  ╔═══════════════════════╗
  327.  ║                       ║
  328.  ║  MISCELLANEOUS NOTES  ║
  329.  ║                       ║
  330.  ╚═══════════════════════╝
  331.  
  332.  
  333.   The SEE program reads the entire file into memory before beginning.  On a
  334.   system with a moderately heavy overhead of TSR's (pop-ups), you may have
  335.   around 475K of free memory.  This would allow you to view documents of up to
  336.   225 pages (at 66 average lines per page).  If the pages were packed
  337.   extremely densely with long lines and very little blank space, this could be
  338.   reduced to as little as 70 pages.  In most cases, it is safe to assume that
  339.   the typical user will have enough memory for at least 150 pages.
  340.  
  341.   NOTE TO PROGRAMMERS:  Please remember that if you shell out from a program
  342.   to call up SEE, the available memory may be much less than 475K.
  343.  
  344.  
  345.  
  346.  ╔═══════════════════╗
  347.  ║                   ║
  348.  ║  LICENSING "SEE"  ║
  349.  ║                   ║
  350.  ╚═══════════════════╝
  351.  
  352.  
  353.   SEE is a freeware program, which means you can use it free of charge.
  354.   However, there are certain restrictions with respect to distribution.  See
  355.   the "Distribution" section of the introductory article (type START at the
  356.   DOS prompt to browse the articles).
  357.  
  358.   You can distribute SEE.EXE by itself (subject to distribution terms).  You
  359.   do NOT have to include SEESETUP.EXE or the SEE.CFG file:  SEE will work
  360.   fine even if both files are missing.  If disk space is limited, or if you
  361.   are packaging your product as shareware (i.e. for download), this lets you
  362.   reduce the size of your package.  Please note that you MUST distribute the
  363.   file AMAZE.TXT with SEE.EXE, unless you have purchased a source license or
  364.   made other arrangements with Pinnacle Software.
  365.  
  366.